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© PARTS: 
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• Arduino Uno (1) 



SUMMARY 

The Redpark Serial Cable, which is part of the Redpark Breakout Pack for Arduino and iOS 
available from the Maker Shed , lets you connect the iPhone to Arduino without jail breaking. 
This guide shows you one of the simplest examples: connecting an iOS device to an Arduino 
and turning an LED on and off from an iOS app. 

(This guide written with lots of help from Alasdair Allan ), the author of a book on this very 
topic, iOS Sensor Apps with Arduino . 
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Step 1 — Wire up the RS232 adapter to the Arduino 




• Connect the RS232 adapter's 
power and ground to the Arduino's 
5V and GND pins, respectively. 

• Connect the RS232 adapter's TX to 
the Arduino's RX, and the RS232 
adapter's RX to the Arduino's TX. 
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To develop apps for the iPhone, 
iPad, or iPod touch, you'll need to 
register as an iOS developer. 
Although you can register for free, 
all that gets you is the development 
tools. You won't be able to deploy 
your apps to a real device. It's $99 
a year for an individual developer, 
$299 for Enterprises (this option 
lets you deploy apps directly to 
your team), and free for 
educational institutions (which also 
lets you deploy apps to a team). 



For more information, see 
the iOS Developer Program 
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• If you've never programmed for the 
i Phone before, you can't count on 
this guide to help you. There are 
many learning resources, from 
Stanford's free Developing Apps for 
iOS courses to Matt Neuburg's 
Programming iOS 5 or Alasdair 
Allan's Learning iOS Programming , 
both of which are available in print 
or ebook form. 

• Before you go any further, please 
make sure you can create and run 
simple apps on your iPhone, iPad, 
or iPod touch. It will also be helpful 
if you familiarize yourself 
thoroughly with the Xcode 
development environment. 
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• In Xcode, create a new view-based project. 

• Give you project the name HelloArduino, and choose the appropriate device family 
(iPhone, iPad, or if you're feeling ambitious, Universal, though this will create a bit more 
work for you). 
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• On the left pane of the screen, 
expand your project, and open the 
folder HelloArduino. 

• Next, locate the 
HelloArduinoViewController.xib and 
click on it. This will bring up your 
app's main view, which is blank at 
the moment. 

• Bring up the Object Library 
(View^Utilities^Object Library), 
and drag a Switch to the center of 
your view. 

• Next, show the Attributes Inspector 
(View^Utilities^Attributes 
Inspector) and set the switch's 
State to Off. 
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Now you need to tell the app's code what to do with the switch. 

If you need room on the screen, you can hide the Utilities Pane 
(View^Utilities^Hide Utilities). 







Next, open the Assistant Editor (View^Editor^Assistant), and locate the toolbar above 
the window that appears. 

Click the icon to the right of the left/right arrows and make sure the Assistant Editor is set 
to automatic. It should be showing the HelloArduinoViewController.h file. 

Control-click the switch, and drag from it to the code that appears in the Assistant Editor. 
Hold it just above the "@end" in the code and release. Add a new outlet and name it 
toggleSwitch as shown. 



Do this once again, but instead, add a new action, and name it toggleLED. Save 
the file (File^Save). 
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• The Redpark Serial Cable installation will create a folder in your home directory 
named Redpark Serial SDK. 

• You can download the SDK from the Redpark web site . 




it 



• Open this in the Finder, and select the inc and lib folders, then drag them to your project 
as shown. 

• A dialog will appear; make sure you check the option "Copy items into destinations group's 
folder (if needed)" and click Finish. 
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• Next, you need to import Apple's 
Accessory Framework. To do this, 
click the Project in the left pane, 
then choose Build Phases, and 
open the "Link Binary With" 
section. Click +, locate the 
ExternalAccessory. framework, and 
add it. 




!!!! I M \ HelloArduino HelloArduino > [hJHelloArduinoViewController.pl - No Selection 

77 : 

// HelloArduinoViewController. h 

// HelloArduino 

// 

// Created by Brian Jepson on 7/16/11. 

// Copyright 2B11 O'Reilly Media. All rights reserved. 

// 

#import <UIKit/UIKit.h> 
#import "RscMgr.h" 

#define BUFFER_LEN 1924 

^interface HelloArduinoViewController : UlViewController <RscMgrDelegate> { 

RscMgr +rscNgr; 

UlntB rKBuffer[BUFFER_LEN] : 

UlntB txBuffer[BUFFER_LEN] ; 

UI5witch ^toggleSwitch: 
} 

^property (nonatomic, retain) IBDutlet UlSwitch +toggleSwitch: 
- (IBAction)toggleLED: (ic) sender: 

@enC 



• Select the 
HelloArduinoViewController. h file to 
open it for editing. 

• Visit my modified version of the file 
at GitHub . 

• Edit your copy of the file: 



Add the two lines between 

#import <UIKit/UIKit.h> 
and @interf ace 

Modify the @interf ace line to 
match mine. 

Add the three lines just above 

UlSwitch * toggle Switch; . 



• Save the file (File^Save). 
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Step 10 — Add some functions to the app delegate 



I M j HelloArduino > £ HelloArduino • m HelloArduinoViewControllerm ■ No Selection 



ti 

// HelloArduinoViewController.m 

// HelloArduino 

t/ 

// Created by Brian Jepson on 7/16/11. 

// Copyright 2811 O'Reilly Media. All rights reserved. 

// 

#import "HelloArduinoViewController. h" 

@ implementation HelloArduinoViewController 
^synthesize toggle5witch; 

- {void) dealloc 
{ 

[toggleSwitch release] : 
[super dealloc] ; 
> 

- (void)didReceiveMemoryWarning 

{ 

// Releases the view if it doesn't have a superview. 
[super didReceiveMemoryWarning] : 

// Release any cached data, images, etc that aren't in use. 
#pragma mark - View lifecycle 

// Implement viewDidLoad to do additional setup after loading the view, typically from a nib. 

- (voic ) viewDidLoad 
{ 

[super viewDidLoad]; 

rscMgr = [ [RscHgr alloc] init] ; 

[rscMgr setDelegate: self] ; 



(voic ) viewDidUnload 

[self setToggleSwitch: nil] ; 
[super viewDidUnload] : 




• Select the 
HelloArduinoViewController.m file 
to open it for editing. 

• Visit my modified version of the file 
at GitHub then edit your copy of the 
file: 

• Locate the viewDidLoad 

method and replace it with my 
version of it. 

• Be sure to Remove the 
comment delimiters 
(/* and */) before and after 
it. 

• Implement the methods required 
by the RscMgrDelegate protocol 
(add everything from my file 

from the #pragma mark - 

RscMgrDelegate methods to 

the end of the file. 

• Locate the toggieLED method 

and replace it with my version of 
it. 

• Save the file (File^Save). 
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Step 11 — Declare support for the serial cable 



- . HelloArduino 
1-3 2 targets, i05SDK4.3 


Q 


Key 


Type 


Value 


Localization native development region 


String 


en 


&: External Accessory, framework 

► Q_ inc 

► Cjlib 

HelloArduino 

[h] HelloArduinoAppDeSegate.h 
|mj HelloArduinoAppDeJegate.m 

v MainWindow.xib 
[hj HelloArduinoViewController.ri 
|mj HelloArduinoViewController.m 
HelloArduinoViewController.xib 

7J Supporting Files 







□ 
□ 


Bundle display name 


String 


i1PRODUCT_NAME* 


Executable file 


String 


${EXECUTABLE_NAME& 


Icon file 


String 




Bundle identifier 


String 


com,makeprojects.S[PRODUCT_ 


Info Dictionary version 


String 


6.0 


Bundle name 


String 


51PRODUCT_NAME} 


Bundle OS Type code 


String 


APPL 


Bundle versions string, short 


String 


1.0 


Bundle creator OS Type code 


String 


1777 


Bundle version 


String 


1.0 


HdloArduino-lnfo-plist 




Application requires iPhone environmei 


Boolean 


YES 


InfoPlist. strings 

[h'| HelloArduino-Prefix.pch 

|m| main.m 
HelloArduinoTests 
Frameworks 
Products 


Main nib hie base name 


Str ng 


MainWindow J 


► Supported interface orientations 


Array 


[3 items) 


▼ Supported external accessory protocols 


Array 


(1 item) 


Item OO 


String 


com. redpark. hobdb9 






• This step is optional, but it 
will avoid the problem of you 
seeing an error message ("This 
accessory requires an 
application...") each time you plug 
in the cable. 

• In Xcode, expand the Supporting 
Files group and click on Hello- 
Arduino. plist to open it. 

• Right-click the bottom row, and 
choose Add Row. Click the 
up/down pointing arrows to the right 
of the new row's key (it will 
probably default to "Application 
Category") and choose "Supported 
external accessory protocols". 

• Click the triangle to the left of the 
key name you just selected to open 
up the list. In the value field for 
Item 0, type 

com. redpark . hobcib9. 

• Save the file (File^Save). 
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Step 12 — Deploy and test the Arduino sketch 



% Arduino File Edit Sketch Tools Help 



^ r\ r\ 



RedparkToggle | Arduino 0022 




RedparkToggle 



void setup() { 
Serial .begin(9600); // Start the serial port 
pinMode(13, OUTPUT); // Set the built-in LED to output mod^ 

} 

void loop() { 

if (Serial .avai lab le()) { // If there's anything on the serial port, 
byte cmd = Serial .readQ; // read a single byte from it. 

if (cmd == '1') { // If the command is the character '1 ' , 
digitaLWrite(13, HIGH); // set the LED on 

} 

if (cmd == '0') { // If the command is the character '0', 

digitaLWrite(13, LOW); // set the LED off 

Serial .print(cmd, BYTE); 
} 




• Grab a copy of the sketch from 
GitHub . 

• Connect your Arduino to your 
computer. 

• Run the Arduino IDE and upload 
the RedparkToggle sketch to your 
Arduino. 

• Temporarily disconnect the jumper 
wire going to the Arduino's RX pin 
(the green cable shown in the first 
step), and upload your sketch. 

• You must disconnect it 
before uploading a sketch 
because the RS232-TTL adapter 
will otherwise interfere with the 
upload process. Leave the jumper 
wire disconnected until you 
complete the next step. 
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Step 13 — Test the Arduino 




• Open the Arduino's serial monitor 
(Tools^Serial Monitor), and make 
sure it's set to 9600 baud. 

• Wait a few seconds for the sketch 
to restart, then type 1 and click 
Send. The LED should come on. 
Try that again with instead of 1 , 
and the LED should go off. 

• Reconnect the jumper wire when 
you're done. 



Step 14 — Deploy the app 




• Connect your i Phone, iPad, or iPod 
touch to your Mac with a dock 
cable. 

• Make sure Xcode is configured to 
run it on the device you just 
connected (see the figure). 

• Click the Run button in Xcode. 

• If you get any errors, review 
the preceding steps to make 
sure you followed them exactly. If 
you still have problems, you can 
try downloading the project from 
GitHub. 




© Make Projects 



www.makeprojects.com 



Page 12 of 13 



Connect an iPhone, iPad, or iPod touch to Arduino with the Redpark Serial Cable 



Step 15 — Run the app 




• The app is running on your iOS 
device, but you need to swap 
cables next, so click Stop in Xcode 
and disconnect the dock cable. 

• Plug the Redpark Serial Cable into 
your device and into the RS232 
serial adapter. 

• Locate the HelloArduino app on the 
home screen, and run it. 



If everything is working correctly, you'll be able to turn the Arduino's built-in LED on and off by 
tapping the switch button! 

This document was last generated on 201 2-1 1 -03 03:1 3:04 AM. 
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